home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / ugly174.zip / UGLYMRG.DOC < prev    next >
Text File  |  1992-07-05  |  8KB  |  213 lines
  1.  
  2.                            The UGLY Merges
  3.                             by Tom Collins
  4.                                07-05-92
  5.  
  6. |    Documentation Changes
  7.      ---------------------
  8.  
  9. |    Differences in the documentation between this version of the UGLY
  10. |    merges, and the documentation for the UGLY merges to RBBS v17.3C
  11. |    are indicated by a vertical bar in the left hand column.
  12.  
  13.      What
  14.      ----
  15.  
  16. |    The UGLY merges are a set of merges for RBBS-PC v17.4 that change how
  17. |    RBBS looks to the remote user and adds a few minor bugs fixes. The
  18. |    current version is compatible with RBBS v17.4, with or without the
  19. |    RFIX0704 fixes.
  20.  
  21.      Differences from the "Straight" RBBS-PC
  22.      ---------------------------------------
  23.  
  24.      o  Most of the prompts are different, most only slightly.  These
  25.         changes (hopefully) should make RBBS appear more "user friendy."
  26.  
  27.      o  Inconsistent line spacing and error handling is handled better.
  28.  
  29. |    o  RBBS won't clear the screen before doing a file transfer.
  30.  
  31. |    o  New users now have a reasonable "since" date for the new files
  32. |       scan.
  33.  
  34.      Compatibilty
  35.      ------------
  36.  
  37. |    This set of merges should work with RBBS v17.4, but won't work with
  38. |    other RBBS versions, including any of the v17.3x releases.  If a new
  39. |    RBBS version comes out, look for a new set of UGLY merges.
  40.  
  41.      In addition, the UGLY merges may or may not be compatible with other
  42.      merges to RBBS.  To find incompatibilities, look at the UGLY merges and
  43.      other merges with a text editor, and look for common line numbers.
  44.      This indicates that two sets of merges want to change the same section
  45.      of RBBS code.
  46.  
  47.      The UGLY merges are entirely compatible with the ANSIED EDIT and ETOG
  48.      merges, though, and in fact are usually used together.
  49.  
  50.      What's in this ZIP
  51.      ------------------
  52.  
  53.      UGLYMRG.DOC   - What you're reading now.
  54.  
  55.      R???UGLY.MRG  - Merges to the various RBBS-PC modules.
  56.  
  57.      UPGRADE4.BAT  - RBBS recompile batch file.  Uses QB v4.5.
  58.  
  59.      UPGRADE3.BAT  - RBBS recompile batch file.  Uses QB v3.0.
  60.  
  61. |    UPGRADE7.BAT  - RBBS recompile batch file.  Uses PDS v7.1.
  62.  
  63.      VARMOD.*      - C program to create RBBS-VAR.MOD (used by ANSIED.BAS)
  64.                      from RBBS-VAR.BAS.  Used in the UPGRADEx.BAT batch
  65.                      files, if you're also merging in ANSIED.
  66.  
  67.      FIXES.DOC     - BULLET6-style documentation for the "fixes" contained
  68.                      in the UGLY merges.
  69.  
  70. |    Merging the UGLY merges into RBBS v17.4
  71.      ----------------------------------------
  72.  
  73. |    To make the UGLY merges to RBBS v17.4, using QuickBASIC v4.5, follow
  74.      these steps:
  75.  
  76.      a) Put all of the R*.BAS files in a work directory, along with the
  77.         .OBJ version of all of the assembler routines.  The R*.BAS files
  78.         usually come from a file called RBBS-BAS.ZIP.  The .OBJs are
  79.         usually in RBBS-ASM.ZIP.  Also, make sure that VARMOD.EXE is in
  80.         this directory.
  81.  
  82.      b) Edit UPGRADE4.BAT to reflect your paths.  UPGRADE4 assumes the
  83.         following paths:
  84.  
  85.         BC.EXE        (QuickBASIC v4.5 compiler)   - C:\QB45
  86.         BLED.EXE      (Goosen's merge program)     - C:\QB45
  87.         BCOM45.LIB    (QuickBASIC library)         - C:\QB45\LIB
  88.         LINK.EXE      (Microsoft linker)           - In the PATH
  89.         R*.BAS        (RBBS .BAS files)            - Current Directory
  90.         *.OBJ         (RBBS .OBJ files)            - Current Directory
  91.         VARMOD.EXE    (RBBS-VAR.BAS converter)     - Current Directory
  92.  
  93.      c) Run UPGRADE4 as follows:
  94.  
  95.             upgrade4 ugly y
  96.  
  97.         Note:
  98.  
  99.         The generic form of the UPGRADE4 command line is:
  100.  
  101.             upgrade4 xxxx <y/n>
  102.                      ^      ^
  103.                      |      |
  104.                      |      +-- compile after merging?
  105.                      |
  106.                      +-- merges name ... R-PCxxxx.MRG or RSB2xxxx.MRG
  107.                                          will be merged. (4 chars)
  108.  
  109.         So, UPGRADE4 can be used for RBBS version/fix upgrades, as well as
  110.         for the UGLY merges.  Here's a command line for RBBS v17.3 -> v17.3A:
  111.  
  112.             upgrade4 173a y
  113.  
  114.         To just compile RBBS, without merging anything, specify a merge
  115.         name that doesn't exist.  Like this:
  116.  
  117.             upgrade4 junk y
  118.  
  119.      d) If all goes correctly, you should have a new RBBS-PC.EXE in your
  120.         current directory.  Copy this version on top of your old version,
  121.         (You backed it up first, right?).
  122.  
  123.      You should be up and running!
  124.  
  125.      Multiple Merges
  126.      ---------------
  127.  
  128.      UPGRADE4 can also be used to implement multiple merges into RBBS.  For
  129.      example, the latest RBBS-PC version upgrade merges have to be applied
  130. |    to the source code for v17.4.  To change versions from v17.4 to
  131. |    v17.4A/0704, and include the UGLY merges, you could do this (to the base
  132. |    v17.4 code):
  133.  
  134. |       upgrade4 0704 ugly y
  135.  
  136.      To add in ANSIED, you could do this:
  137.  
  138.         upgrade4 0704 ugly edit y
  139.  
  140. |    About Merges
  141. |    ------------
  142.  
  143. |    RBBS-PC is distributed with source code.  When a change or fix needs
  144. |    to be made to it, a set of "merges" is distributed, which are the
  145. |    DIFFERENCE between the original source code and the new source code.
  146. |    These merges are applied to the original source code with a program
  147. |    called BLED.  BLED takes the original source code and applies the
  148. |    changes to create a new set of source code, which is then recompiled
  149. |    to produce a new EXE.
  150.  
  151. |    Merges are distributed as a set of files with the MRG extension, and
  152. |    are generally named in this format:
  153.  
  154. |       XXXXYYYY.MRG, where:
  155.  
  156. |           XXXX - Program to be applied against (R-PC for RBBS-PC.BAS, or
  157. |                  RSBx to be applied against RBBSSUBx.BAS).
  158.  
  159. |           YYYY - Merge name, like UGLY or 0901.
  160.  
  161.      Getting the Latest Version
  162.      --------------------------
  163.  
  164.      The UGLY merges were created to spice up a standard RBBS
  165.      implementation, and new version will probably be distributed as
  166.      required.  In general, the latest version is available to any FidoNet
  167.      sysop who cares to request it.  To File request the UGLY merges, send
  168.      a file request to the MSFA BBS, Arbutus, MD, FidoNet node
  169.      1:261/1047, and request the magic name "UGLY" (without the quotes). If
  170.      you're not a FidoNet sysop, and would like to obtain the latest
  171. |    version, try the MSFA BBS (1-410-536-1935), under the F)ree
  172.      downloads.
  173.  
  174.      Reaching the Author
  175.      -------------------
  176.  
  177.      To reach the author, enter a message in the FidoNet RBBS-PC echomail
  178.      conference, or leave a message on the MSFA BBS.  You may also be able
  179.      to reach "old whatshisname" on the RBBS conference on RIME.
  180.  
  181.      Using the UGLY merges with ANSIED
  182.      ---------------------------------
  183.  
  184.      If you'd like to merge ANSIED, the RBBS full-screen editor in with the
  185. |    UGLY merges, you should get the new EDIT174.ZIP file, which contains
  186. |    the EDIT and ETOG merges for RBBS-PC v17.4.  Remember, on the
  187.      UPGRADE4 command line, use UGLY and then EDIT (or ETOG).
  188.  
  189.      Other Compilers
  190.      ---------------
  191.  
  192.      The UGLY merges also work with QuickBASIC v3.0, but you'll have to use
  193. |    the UPGRADE3 batch file.  To use Microsoft's PDS compiler, use the
  194. |    UPGRADE7 batch file.
  195.  
  196.      You can't use the UGLY merges with QuickBASIC v2.01 or BASCOM v1.00,
  197.      because they use some of the v3.0+ statements.  They should be
  198.      compilable with some of the newer MicroSoft BASIC compilers, though I
  199.      won't swear to it.
  200.  
  201. |    Linker Errors
  202. |    -------------
  203.  
  204. |    Some people have reported problems with my merges, and the problem has
  205. |    been tracked down to using the improper LINK.EXE program.  One of
  206. |    these is supplied with DOS, but you should make sure that the one
  207. |    which came with your BASIC compiler is the one that gets used.
  208. |    Remember, the UPGRADEx batch files assume LINK.EXE is in your DOS path.
  209. |    Make sure that the one you want to use occurs first in your path.
  210.  
  211.      -- Tom Collins
  212.  
  213.